Type: concept
Confidence: 0.70
Created: 2026-04-25
Updated: 2026-04-25
Tags: versioningdocumentationmaintenanceAI工程

ERRATA mechanism

概述

ERRATA机制是jezweb/claude-skills项目中的版本变更管理方法,用于优雅处理库更新导致的内容过时问题。

关键内容

  1. 设计理念
  2. 当库更新导致Skill内容过时时,不立即修改SKILL.md,而是创建ERRATA.md
  3. 保持Skill内容稳定,同时提供即时的错误修正能力

  4. 文件结构skill-name/ ├── SKILL.md # 核心内容(稳定,少改) ├── ERRATA.md # 版本变更记录(活跃更新) └── references/ └── REFERENCE.md

  5. 状态生命周期

  6. active(当前有效的纠正)
  7. → absorbed(已折叠进SKILL.md
  8. → outdated(库又变了,本条记录已过期)

  9. 应用场景

  10. 库更新导致原Skill内容失效
  11. 发现Skill中的错误需要临时修正
  12. 保持向后兼容的同时提供最新信息

来源

相关